home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 26 / CU Amiga Magazine's Super CD-ROM 26 (1998)(EMAP Images)(GB)[!][issue 1998-09].iso / CUCD / Utilities / TrueTypeLib / readme < prev    next >
Text File  |  1998-07-12  |  6KB  |  179 lines
  1. ttf.library
  2.  
  3. Overview
  4.  
  5. ttf.library is a truetype compatible font engine for Amiga OS.
  6. It functions in a manner compatible with the outline font engine
  7. standard established by Commodore with the bullet.library engine
  8. for compugraphic format fonts. This means that Amiga applications
  9. which use normal system fonts should now be able to use truetype
  10. format fonts.
  11.  
  12.  
  13. Installation
  14.  
  15. The following files are provided to facilitate using truetype
  16. fonts:
  17.  
  18. File         Installation instructions
  19. ------------ ------------------------------------------------------
  20. ttf.library  copy to your LIBS: drawer
  21. ttfinstall   copy to your favorite tool drawer (i.e. sys:utilities)
  22. ttflist       "   "   "      "      "     "    (optional)
  23. ftview        "   "   "      "      "     "    (optional)
  24.  
  25.  
  26.  
  27. Usage
  28.  
  29. To use a truetype font, it must first be installed to some part
  30. of the system FONTS: drawer. Installation is a bit different than
  31. with the compugraphic intellifont program. First this is a CLI
  32. program, not a workbench program. Second, the outlines are not
  33. copied to the font directory, instead only the ".font" and ".otag"
  34. files are created in the font directory, which reference the
  35. outline at the same location from which it was installed. This
  36. makes it much easier to use large font libraries directly from
  37. CD-ROM, for example. The third major difference, fonts may be
  38. installed to any drawer, not just a FONTS: component. (Note that
  39. to USE the font in many programs, the drawer must be assigned
  40. to FONTS:, but this allows you to selectively add the required
  41. font path components as needed.)
  42.  
  43. The command line for installing a truetype font would look like
  44. the following:
  45.  
  46.   ttfinstall fontfile.ttf sys:fonts
  47.  
  48. Note that 'fontfile.ttf' is the actual file to be installed, and
  49. 'sys:fonts' can be any existing directory. In addition, a file
  50. name pattern can be specified for 'fontfile.ttf', allowing the
  51. installation of several fonts at once. For example:
  52.  
  53.   ttfinstall cd0:funky/#?.ttf work:ttfonts
  54.  
  55. Would install all the font found in the cd0:funky drawer to the
  56. ttfonts drawer on volume work:
  57.  
  58. Once a truetype font is installed on the fonts: path, it should
  59. be possible to select that font from any decent font requester.
  60.  
  61. Please note that ttfinstall will OVERWRITE the .font and .otag
  62. files if they already exist, thus installing two fonts with
  63. the name 'CoolNewFont' will result in only one available font.
  64. It is possible to rename both the .font and .otag files once
  65. they have been created, so multiple fonts with the same internal
  66. name can be used if you work at it. This will be addressed in
  67. a future version of ttfinstall. For the time being, it is
  68. strongly recommended that you do not insstall directly to your
  69. primary fonts drawer, but to a separate drawer dedicated to
  70. holding truetype fonts. For example, I have a drawer, sys:ttfonts,
  71. that I use for permanently installed ttf's. The following assign
  72. makes that drawer accessible to most well behaved programs:
  73.  
  74.     assign fonts: sys:ttfonts add
  75.  
  76.  
  77.  
  78. Utilites
  79.  
  80. Two additional utilites are provided to assist in the management
  81. of truetype fonts. These are also CLI only. Note that the
  82. ttf.library does not have to be installed to use these tools.
  83.  
  84. ttflist works a lot like the normal system 'list' command, but
  85. is designed to display readable names along with the file name.
  86. Also, it will optionally provide a great deal of perhaps useful
  87. information from a font file. The command line would look like:
  88.  
  89.   ttflist [pattern] [all] [verbose] [encode]
  90.  
  91. where:
  92. [pattern] is an optional amigados file pattern or drawer name.
  93. by default it is "#?.(ttf|ttc)"
  94.  
  95. [all] is an optional switch to list matching drawer contents
  96. as well. Note that the pattern specified must match the drawer
  97. names to be searched. When all is specified the default pattern
  98. is "#?".
  99.  
  100. [verbose] gives a lengthy, and probably ignorable, report for
  101. each font found.
  102.  
  103. [encode] gives a verbose report and displays the results of encoding
  104. mapping all 256 amiga characters against all encoding tables in the
  105. font file. 
  106.  
  107. (verbose and encode are mainly for the developers benefit ;)
  108.  
  109. example:  ttflist cd0: all
  110.  
  111.  
  112. ftview is a truetype font display program from the freetype
  113. project test suite, with very minimal 'amigaizing'. Its command
  114. line format is:
  115.  
  116.   ftview [-g] pointsize fontfile ...
  117.  
  118. where
  119.  
  120. [-g] is an optional grey scale (smoothing) rendering. Smoothing
  121. looks very wonderful, but is not available through ttf.library.
  122. Also note that ftview opens on the default public screen, and
  123. if that screen does not have sufficient available or matching
  124. pen colors, it may look worse. The -g option uses five distinct
  125. grey levels.
  126.  
  127. pointsize is a required argument specifying the point size to
  128. display.
  129.  
  130. fontfile is one or more truetype font files to view.
  131.  
  132. Example: ftview 30 flyingp.ttf
  133.  
  134. While the font is displayed, options to change many rendering
  135. characteristics are available by keystroke or standard amiga
  136. menu selections.
  137.  
  138.  
  139. Credits and Notes
  140.  
  141. The ttf.library and related programs were made possible by
  142. the outstanding achievement known as the FreeType Project.
  143. For more information, visit http://www.freetype.org
  144.  
  145. Also, Amish S. Dave's type1.library (which does for postscript
  146. type1 fonts what ttf.library does for truetype) served as an
  147. invaluable guide and model for the rather poorly documented
  148. amiga outline font engine format.
  149.  
  150.  
  151. Bugs, warnings
  152.  
  153. This software has had minimal testing. Its performance on
  154. the development machine has been constantly monitored with
  155. enforcer and mungwall, however, it is still unproven. Also,
  156. it relies VERY heavily on code which I did not write, and
  157. have not examined in great detail. (Although, I must note
  158. that the FreeType code seems very solid!) Please use caution,
  159. and use at your own risk.
  160.  
  161. Several feature of the bullet library standard have not yet
  162. been implemented (rotation, shearing, width lists and various
  163. inquiries fall into this category, as they are not required for
  164. proper operation via the diskfont.library.) Programs expecting
  165. to use advanced features of the bullet.library may not work
  166. as expected with the ttf.library. FinalWriter from Softwood is
  167. one such program. This IS being worked on.
  168.  
  169. Internationalization is very weak at this point.
  170.  
  171. Send any comments, suggestions, bug reports to:
  172.  
  173.     Richard Griffith
  174.     ragriffi@sprynet.com
  175.  
  176.  
  177.  
  178.  
  179.